home *** CD-ROM | disk | FTP | other *** search
/ HPAVC / HPAVC CD-ROM.iso / pc / SOURCE.ZIP / HC.ZIP / HCDOC.TXT < prev    next >
Encoding:
Text File  |  1989-08-10  |  40.0 KB  |  978 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                                 H E X C A L I B U R
  17.                                 = = = = = = = = = =
  18.  
  19.  
  20.                             The
  21.  
  22.                                       Hex
  23.  
  24.                                                  Editor
  25.  
  26.  
  27.                                    Version 1.02
  28.  
  29.  
  30.                             Reference            Manual
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.                             Gregory Publishing Company
  50.                             333 Cobalt Way, Suite 107
  51.                             Sunnyvale, California, 94086
  52.                                   (408) 727-4660
  53.  
  54.  
  55.                      Copyright (c) 1989 Gregory Publishing Company
  56.                                  All Rights Reserved
  57.  
  58.                                    LICENSE
  59.                                    =======
  60.  
  61.  
  62. All versions of "HEXCALIBUR -- The Hex Editor" are NOT public domain software,
  63. nor are they free software.
  64.  
  65. Non-registered users are granted a limited license to use Hexcalibur on a trial
  66. basis for the purpose of determining whether or not it may be suitable to their
  67. needs.  Any use of Hexcalibur, except for this limited purpose, requires
  68. registration.  Any use of copies of Hexcalibur that are not registered by any
  69. individual, corporation, private enterprise, governmental agency, or other
  70. entity or institution is strictly forbidden.
  71.  
  72. Registration permits a user the license to use Hexcalibur on a single computer. 
  73. The registered user may use Hexcalibur on more than one computer, but it must
  74. not be used on two or more computers at the same time.
  75.  
  76. No user may modify Hexcalibur in any way, including, but not limited to,
  77. decompiling, disassembling, or otherwise reverse engineering the program.
  78.  
  79. All users are encouraged to copy Hexcalibur for the trial use of others subject
  80. to the above mentioned restrictions and also subject to the following
  81. conditions:
  82.  
  83. (1) Hexcalibur must be copied without modification, complete with the file
  84.     containing this license information.
  85.  
  86. (2) Verbal or written notice must be given the person receiving the copy that
  87.     use of Hexcalibur requires the payment of a $30.00 registration fee to
  88.     Gregory Publishing Company.
  89.  
  90. (3) All support files must be included with the copy.  These files are:
  91.       HC.EXE        --   The Hexcalibur program.
  92.       HCDOC.TXT     --   This document.
  93.       SAMPLE1.TXT   --   A sample file of data characters.
  94.       HCMONO.FIL    --   The black and white colors file.
  95.       Any README or HEXNOTES files that may be on the original disk.
  96.  
  97. (4) Hexcalibur may not be distributed along with any other product.
  98.  
  99. Operators of electronic bulletin board systems (Sysops) may post Hexcalibur for
  100. downloading by their users providing the above conditions are met.
  101.  
  102. Distributors of public domain or user supported software may distribute copies
  103. of Hexcalibur subject to the above conditions.
  104.  
  105. An order form is included in this file which may be used to register your copy
  106. of Hexcalibur.
  107.  
  108.  
  109. THANK YOU FOR YOUR SUPPORT!
  110.  
  111.                                    WARRANTY
  112.                                    ========
  113.  
  114.  
  115. Gregory Publishing Company makes no warranty of any kind, express or implied,
  116. including without limitation, any warranties or merchantability and/or fitness
  117. for a particular purpose.  Gregory Publishing Company shall not be liable for
  118. any damages, whether direct, indirect, special, or consequential arising from a
  119. failure of this program to operate in the manner desired by the user. Gregory
  120. Publishing Company shall not be liable for any damage to data or property which
  121. may be caused directly or indirectly by use of this program.
  122.  
  123. IN NO EVENT SHALL GREGORY PUBLISHING COMPANY BE LIABLE TO YOU FOR ANY DAMAGES,
  124. INCLUDING ANY LOST PROFITS, LOST SAVINGS, OR OTHER INCIDENTAL OR CONSEQUENTIAL
  125. DAMAGES ARISING OUT OF YOUR USE OF OR INABILITY TO USE HEXCALIBUR, OR FOR ANY
  126. CLAIM BY ANY OTHER PARTY.
  127.  
  128.  
  129.                              ORDERING  INFORMATION
  130.                              ========  ===========
  131.  
  132.  
  133. Registration of Hexcalibur licenses you to use the product for any reasonable
  134. purpose as you need.  Users need only register one version of Hexcalibur. 
  135. Registration automatically includes licensed use of all upgrades.
  136.  
  137. The version of Hexcalibur on this disk is version 1.02, dated August, 1989.
  138. Depending upon how long after August, 1989, you are reading this, there may be
  139. later versions of Hexcalibur available.  We have a large list of enhancements
  140. already planned for future versions.
  141.  
  142. Upon receipt of your payment for registration, we will automatically ship you
  143. (providing you supply a clearly written mailing address and phone number) the
  144. most current version of the program.  Additional updates are available to
  145. registered users ONLY for a nominal fee of $10.00 per disk.
  146.  
  147. Please use the order form supplied on the next page when placing an order.
  148.  
  149.  
  150.  
  151.  
  152. NOTICE TO CUSTOMERS OUTSIDE NORTH AMERICA:
  153.    Please send only checks that are drawn on a US Bank that are payable in
  154.    US Dollars.  Please add an additional $1.50 to cover postage for the
  155.    mailing of the diskette outside the USA.
  156.  
  157.  
  158.                                  ORDER      FORM
  159.                                  =====      ====
  160.                              Gregory Publishing Company
  161.                           333 Cobalt Way, Suite 107, Dept. F1
  162.                              Sunnyvale, California  94086
  163.                                    (408)  727-4660
  164. Quantity   Item
  165. --------   ----
  166.  
  167. ________   Registration for Hexcalibur ............. @ $30.00 ea  $ ___________
  168.              (Includes one copy on disk of the most current version.)
  169.  
  170. ________   Upgrade of Hexcalibur ................... @ $10.00 ea  $ ___________
  171.              (For already registered users only.)
  172.  
  173.  
  174. Recordings from Gregory Publishing Company on cassette tape:
  175. ------------------------------------------------------------
  176.  
  177. ________  Synthesized Sullivan, volume I ........... @ $ 9.00 ea  $ ___________
  178.             (Gilbert & Sullivan overtures orchestrated on a synthesizer.)
  179.  
  180. ________  Synthesized Sullivan, volume II .......... @ $ 9.00 ea  $ ___________
  181.  
  182.  
  183. Documentation for Unisys A-Series Computer Systems:
  184. ---------------------------------------------------
  185.  
  186. ________  The Complete CANDE Primer ................ @ $30.00 ea  $ ___________
  187.  
  188. ________  The Extended ALGOL Primer, volume I ...... @ $25.00 ea  $ ___________
  189.  
  190. ________  The Extended ALGOL Primer, volume II ..... @ $29.00 ea  $ ___________
  191.  
  192. ________  The Extended ALGOL Primer, volume III .... @ $31.00 ea  $ ___________
  193.  
  194. ________  A-Series DMSII Programming ............... @ $40.00 ea  $ ___________
  195.  
  196. ________  Gregory's A-Series Technical Journal ..... @$225.00 ea  $ ___________
  197.             (Annual subscription, 10 issues per year.)
  198.                                                        SUBTOTAL   $ ___________
  199.  
  200.                    California Residents add applicable Sales Tax  $ ___________
  201.                      (No sales tax on Journal subscriptions)
  202.  
  203.                                                           TOTAL   $ ___________
  204.  
  205.  
  206. Name: _____________________________________________________________
  207.  
  208. Company: __________________________________________________________
  209.  
  210. Address: __________________________________________________________
  211.  
  212.          __________________________________________________________
  213.  
  214. Phone:   __________________________________________________________
  215.  
  216. Pre-paid orders only.  Purchase orders o.k. if TOTAL amount exceeds $100.00.
  217.  
  218.                       Corporate/Government/Multiple Users
  219.                       ===================================
  220.  
  221.  
  222. All corporate, business, government, and other commercial users of Hexcalibur
  223. must register.
  224.  
  225. The registration fee for the first license of Hexcalibur is $30.00. This price
  226. includes the delivery of an updated disk which will be mailed to the licensee.
  227.  
  228. Additional registration fees for users AT THE SAME ORGANIZATION are $25.00 each
  229. for 2 - 20 users and $20.00 each per additional user after that.  This fee is
  230. for registration only.  Users are expected to make their own copies of the
  231. updated software from the disk sent the original licensee.  NO DISK WILL BE
  232. MAILED TO A CUSTOMER WHO AVAILS HIMSELF OF ANY DISCOUNTED REGISTRATION FEE.
  233.  
  234. Example:  If your company has five users that want to use Hexcalibur, the
  235. license fee for all five would be:
  236.  
  237.                   $30.00 (for the original license)
  238. + ($25.00 x 4) = $100.00 (for the other four users) 
  239.                  -------
  240.                  $130.00 TOTAL registration fee
  241.  
  242. The first user would be sent an updated disk, and the other four would obtain
  243. copies from that user.
  244.  
  245. If your company has 25 users, all of whom are going to use Hexcalibur, the
  246. registration fee would be:
  247.  
  248.                    $30.00 (for the original license)
  249. + ($25.00 x 20) = $500.00 (for users #2 - 20)
  250. + ($20.00 x 5)  = $100.00 (for users #21 -25)
  251.                   -------
  252.                   $630.00 TOTAL registration fee
  253.  
  254. Not all registrations need be made at once.  After payment of the first
  255. registration, you may take advantage of the discount schedule by adding new
  256. users.  Simply include your ORIGINAL LICENSE NUMBER (which is provided on the
  257. disk mailed to you) with your order, and you will receive the discount.
  258.  
  259.  
  260.  
  261. NOTICE:  YOU MAY NOT USE HEXCALIBUR WITHIN YOUR ORGANIZATION WITHOUT A PRIOR
  262. PURCHASE OR LICENSE ARRANGEMENT.
  263.  
  264.                                   Introduction           
  265.                                   ============
  266.  
  267. Hexcalibur is a high quality editor designed expressly for examining, modifying,
  268. or otherwise manipulating disk files in their raw, or binary, format.  You may
  269. examine and change any part of a file using either hexadecimal characters (4-
  270. bit characters) or standard ASCII characters.  Hexcalibur is especially useful
  271. for examining and editing files that standard ASCII editors either will not read
  272. or will read but display in a format that is not terribly useful.
  273.  
  274. With Hexcalibur, you can:
  275.  
  276. (1) Examine and change the contents of WordStar or other specially encoded
  277.     files.
  278.  
  279. (2) Filter incompatible codes out of files.
  280.  
  281. (3) Convert Unix or BTOS text files (line terminator = 0a) to MS-DOS format
  282.     (line terminator = 0d0a) or to MacIntosh format (line terminator = 0d),
  283.     or vice versa.
  284.  
  285. (4) Examine and change the printer codes in a file to be printed.
  286.  
  287. (5) Search game programs for clues in the text portion of the codefile.
  288.  
  289. (6) Examine and change soft font data files for laser printers.
  290.  
  291. (7) Examine incoming .COM and .EXE files for software virus patterns and,
  292.     possibly, eradicate them.
  293.  
  294. ...and much more!  New ideas for using this product come to mind every day!
  295.  
  296. The key to doing any of these things is THAT YOU KNOW WHAT YOU ARE DOING.
  297. Hexcalibur does not advise you or attempt to protect you from yourself. It will
  298. let you do anything to a file at the binary level.  If you change an executable
  299. codefile, you had better know what you are doing!  But for those who know,
  300. Hexcalibur provides a convenient tool for making the kind of changes that, until
  301. now, were extremely difficult to do!
  302.  
  303. An immediate use of Hexcalibur can be illustrated using this documentation file
  304. you are now reading.  This file is formatted for printing on any printer that
  305. uses the sequence "Form Feed/Carriage Return" ("0c0d" character sequence) as a
  306. page separator.  If your printer does not use that character sequence, but uses
  307. something else, you can easily change this file to print on your printer.
  308.  
  309. Suppose, for example, that your printer uses the hex character sequence "1f" as
  310. its form feed instruction.  You could change every "0c0d" in this file to "1f"
  311. by taking the following steps:
  312.  
  313. Beginning at the MS-DOS prompt, proceed as follows.  (The step numbers are for
  314. reference purposes only.  Do not type them in.  "Alt" refers to the "Alt key",
  315. and <ENTER> refers to the "ENTER key.")
  316.  
  317. 1. HC HCDOC.TXT
  318.  
  319. 2. press any key to leave the greeting screen
  320.  
  321. 3. Alt-R
  322.  
  323. 4. 0c0d <ENTER>
  324. 5. 1f <ENTER>
  325.  
  326. 6. when the confirm prompt appears, type:
  327.      r
  328.  
  329. 7. Alt-X
  330.  
  331. 8. y
  332.  
  333. 9. <ENTER>
  334.  
  335. Now print the file using the MS-DOS PRINT command, and you will find that it
  336. will eject pages properly on your printer that uses "1f" as a page eject
  337. instruction.
  338.  
  339.  
  340. The pages that follow provide instructions on how to use Hexcalibur. Hexcalibur
  341. has been designed for intuitive operation.  Most of the commands are accessed by
  342. different Alt keys.  (For example, Alt-B moves to the beginning of the file,
  343. Alt-E to the end, Alt-F is FIND, Alt-R is REPLACE, and so forth.) Wherever
  344. possible, standard DOS keys have been used for various paging functions.  (For
  345. example, the cursor arrows work as expected; if you move to a line off of the
  346. screen, the screen will scroll one line; Page Up and Page Down may be used to
  347. move through the file in 256-character blocks.)
  348.  
  349. An on-line summary of the commands is readily available by pressing function key
  350. F1.  Use this screen for quick reference to any command.
  351.  
  352. The screen colors are user-configurable.  If the appearance of the screen is not
  353. right for your computer, type Alt-C.  This will bring up the Color Menu. Once in
  354. the Color Menu, use the cursor arrows to change colors.  The Left and Right
  355. arrows change the foreground color, while the Up and Down arrows change the
  356. background color.  When you have your screen colors set as desired, press the
  357. ENTER key to save them.  They will be saved in a file called HC.FIL and will be
  358. available for all future runs of Hexcalibur.
  359.  
  360.  
  361.                                   Installation
  362.                                   ============
  363.  
  364. To install Hexcalibur onto a hard disk system, proceed as follows:
  365.  
  366. 1. Insert the floppy into a floppy drive.  (We will assume you are using
  367.    drive A.)
  368.  
  369. 2. Select the drive you want the program to run from.  For example, if you want
  370.    the program on drive C, enter:
  371.      C:
  372.  
  373. 3. Change to the directory you want the program to run from.  For example, to
  374.    put the program under the directory DOS, enter:
  375.      CD DOS
  376.    For best results, put Hexcalibur into a directory that is part of your
  377.    normal PATH.
  378.  
  379. 4. COPY A:*.*
  380.  
  381. 5. Set your screen colors.  To do this, enter:
  382.      HC SAMPLE1.TXT
  383.      Alt-C
  384.      Select your colors as described in "Color Selections" (later in this
  385.        document).
  386.      Exit the color menu by pressing the ENTER key.
  387.      Exit the program (if desired) by entering:
  388.        Alt-X
  389.  
  390.    Your screen color selections are now saved in a location that is visible
  391.    to your DOS PATH.  Hexcalibur will therefore find the color file every
  392.    time you run it.  (You can also make additional color files under other
  393.    directories if you wish to use different colors in different locations.)
  394.  
  395. 6. Mail in your Registration on the enclosed order form.  If possible, please
  396.    let us know to what use you plan to put this program to.
  397.  
  398. 7. Make a copy of the original diskette and give it to a friend.
  399.  
  400.                                    Hexcalibur
  401.                                    ==========
  402.  
  403.                               Command Summary List
  404.                               --------------------
  405. Function                                                        Key Sequence
  406. --------                                                        ------------
  407.  
  408. Move 1 character to the left. . . . . . . . . . . . . . . . . . Left Arrow
  409. Move 1 character to the right . . . . . . . . . . . . . . . . . Right Arrow
  410. Move Up 1 line; scroll 1 line if at top of screen . . . . . . . Up Arrow
  411. Move Down 1 line; scroll 1 line if a bottom of screen . . . . . Down Arrow
  412.   (Each line is 16 characters long.)
  413. Move Up 1 page. . . . . . . . . . . . . . . . . . . . . . . . . Page Up
  414. Move Down 1 page. . . . . . . . . . . . . . . . . . . . . . . . Page Down
  415.   (Each page is 256 characters in length.)
  416.  
  417. Beginning of line . . . . . . . . . . . . . . . . . . . . . . . Home
  418. End of line . . . . . . . . . . . . . . . . . . . . . . . . . . End
  419. Beginning of file . . . . . . . . . . . . . . . . . . . . . . . Alt-B or Alt-0
  420. Move in 10% of the file . . . . . . . . . . . . . . . . . . . . Alt-1
  421. Move in 20% of the file . . . . . . . . . . . . . . . . . . . . Alt-2
  422. Move in 30% of the file . . . . . . . . . . . . . . . . . . . . Alt-3
  423. Move in 40% of the file . . . . . . . . . . . . . . . . . . . . Alt-4
  424. Move in 50% of the file . . . . . . . . . . . . . . . . . . . . Alt-5
  425. Move in 60% of the file . . . . . . . . . . . . . . . . . . . . Alt-6
  426. Move in 70% of the file . . . . . . . . . . . . . . . . . . . . Alt-7
  427. Move in 80% of the file . . . . . . . . . . . . . . . . . . . . Alt-8
  428. Move in 90% of the file . . . . . . . . . . . . . . . . . . . . Alt-9
  429. End of file . . . . . . . . . . . . . . . . . . . . . . . . . . Alt-E
  430.  
  431. Go to specific sector and byte. . . . . . . . . . . . . . . . . Alt-G
  432.   (Type in the desired sector and byte number and press ENTER.)
  433. Switch between Hex Window and Text Window . . . . . . . . . . . F2
  434.  
  435. Toggle Insert Mode/Overtype Mode. . . . . . . . . . . . . . . . Insert
  436. Delete Character. . . . . . . . . . . . . . . . . . . . . . . . Delete
  437.   (In the Hex window, both hexades are deleted at once.)
  438.  
  439. Begin Block . . . . . . . . . . . . . . . . . . . . . . . . . . Alt-A
  440.   Initiate Copy of Selected Block . . . . . . . . . . . . . . . Alt-C
  441.   Initiate Move of Selected Block . . . . . . . . . . . . . . . Alt-M
  442.   Delete Selected Block . . . . . . . . . . . . . . . . . . . . Alt-D
  443. Retrieve most recently selected Block for Pasting . . . . . . . Alt-P
  444.  
  445. Find text . . . . . . . . . . . . . . . . . . . . . . . . . . . Alt-F
  446. Find and Replace text . . . . . . . . . . . . . . . . . . . . . Alt-R
  447.  
  448. Save File . . . . . . . . . . . . . . . . . . . . . . . . . . . Alt-S
  449. Exit Program (with option to save the file) . . . . . . . . . . Alt-X
  450. Quit Program (same as Alt-X). . . . . . . . . . . . . . . . . . Alt-Q
  451. Undo All Changes since the most recent Save . . . . . . . . . . Alt-U
  452.  
  453. Select Screen Colors. . . . . . . . . . . . . . . . . . . . . . Alt-C
  454. Toggle Display All/Display only Printables in the text Window . Alt-Z
  455. Display Product Information . . . . . . . . . . . . . . . . . . Alt-I
  456. View Command Summary. . . . . . . . . . . . . . . . . . . . . . F1
  457.  
  458. Cancel an operation in progress . . . . . . . . . . . . . . . . Esc
  459.  
  460.                               The Screen Layout
  461.                               === ====== ====== 
  462.  
  463.     HEXCALIBUR             Workfile: C:\HEXCAL\NONAME.TXT
  464.  
  465.     Sector: 000   Byte: 000                    F1  - HELP
  466.             0           0                      F2  - Switch Window
  467.     overtype                                   ESC - Cancel Operation
  468.  
  469.      0  1  2  3  4  5  6  7  8  9  A  B  C  D  E  F   0123456789ABCDEF 
  470. 00  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................  00
  471. 10  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................  10
  472. 20  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................  20
  473. 30  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................  30
  474. 40  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................  40
  475. 50  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................  50
  476. 60  00 00 00 00                      00 00 00 00 00   ..            ..  60
  477. 70  00 00 00 00    the hex window    00 00 00 00 00   ..  the text  ..  70
  478. 80  00 00 00 00                      00 00 00 00 00   ..   window   ..  80
  479. 90  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................  90
  480. A0  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................  A0
  481. B0  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................  B0
  482. C0  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................  C0
  483. D0  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................  D0
  484. E0  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................  E0
  485. F0  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................  F0
  486.  
  487.     Size of File: 65536    Available Memory: 365160
  488.  
  489. When first coming up in Hexcalibur, you will notice two large windows taking up
  490. the majority of the screen.  The smaller window on the right side is the text
  491. window, consisting of the character translations of all the bytes in the file. 
  492. The larger one on the left side is the hex window, containing two hex characters
  493. for every byte in the file, one for the lower four bits and one for the upper
  494. four bits.  Each character in the text window has a direct correspondence across
  495. in the hex window, and vice versa.  The screen is laid out so that corresponding
  496. hex and text characters are always visible when editing.  When editing in the
  497. hex window, the corresponding character in the text window is simultaneously
  498. updated; when editing in the text window, the corresponding hex character pair
  499. is also updated.  You may edit in one window at a time and use the F2 command to
  500. switch windows.
  501.  
  502. The top line of the screen consists of the title, HEXCALIBUR and the name of the
  503. workfile being edited, including the name of the path to that file.  Other
  504. features displayed on the screen include the exact location (in sectors and
  505. bytes) of the cursor in the file.  This is displayed in the upper left hand
  506. corner of the screen directly under the title, HEXCALIBUR, and it is updated as
  507. the cursor moves through the file.
  508.  
  509. Beneath the position display is the mode display.  There are three separate
  510. modes:  overtype, insert mode, and block mode.  Overtype and insert mode can by
  511. toggled by the insert key.  Block mode is started by an Alt-A command, and no
  512. editing can take place as in the other two.
  513.  
  514. The bottom line contains the size of the file and the remaining available memory
  515. the editor may use.  The size of the file is updated as editing takes place. 
  516. The available memory changes as blocks of space are assigned, which is typically
  517. in blocks of 8K bytes.
  518.  
  519.                               Color Selections
  520.                               ===== ========== 
  521.  
  522.     HEXCALIBUR             Workfile: C:\HEXCAL\NONAME.TXT
  523.  
  524.     Sector:       Byte:                        F1  - HELP
  525.                                                F2  - Switch Window
  526.     overtype                                   ESC - Cancel Operation
  527.  
  528.      0  1  2  3  4  5  6  7  8  9  A  B  C  D  E  F   0123456789ABCDEF 
  529. 00                  Color Selections                  ...-------------  00
  530. 10                                                    ------||||||||||  10
  531. 20               ......................               ||||||||||||||||  20
  532. 30               .   Current Field:   .               ||||||||||||||||  30
  533. 40               .        TEXT        .               |||||-----------  40
  534. 50               ......................               ----------------  50
  535. 60                                                    ----------------  60
  536. 70    Left/Right cursors   Change text color          ----------------  70
  537. 80    Up/Down cursors      Change background color    ----------------  80
  538. 90                                                    ----------------  90
  539. A0    TAB                  Move to next field         ----------------  A0
  540. B0    Shift-TAB            Move to previous field     ----------------  B0
  541. C0                                                    ----------------  C0
  542. D0    Alt-D                Load default colors        ----------------  D0
  543. E0    ENTER                Return and save changes    ----------------  E0
  544. F0    ESC                  Return without save        ----------------  F0
  545.  
  546.     Size of File:          Available Memory:       
  547.  
  548.  
  549. All color selections are saved in a file named HC.FIL.  If this file is not
  550. found when the program begins running, the editor will come up with its default
  551. colors.  Another indication that it has not been found the HC.FIL file is that
  552. the bottom of the title screen will display "To set screen colors, type Alt-C".
  553.  
  554. To enter the color selection menu once in the editor, use the Alt-C key. 
  555.  
  556. In response to the Alt-C command, the color selections screen will come up.  You
  557. will be able to edit one color field at a time.  The field that is currently
  558. being edited is displayed at the top center of the screen.  There are six
  559. different color fields that you may edit.
  560.  
  561. While editing colors, the functions of the keyboard are redefined thusly:
  562.  
  563.  
  564. Left/Right arrows
  565. -----------------
  566.  
  567. Use the left and right arrow keys to change the current field's foreground text
  568. color.
  569.  
  570.  
  571. Up/Down arrows
  572. --------------
  573.  
  574. Use the up and down arrow keys to change the current field's background color.
  575.  
  576.  
  577. TAB
  578. ---
  579.  
  580. The TAB key shifts the editor to the next field.
  581.  
  582.  
  583. Shift-TAB
  584. ---------
  585.  
  586. The Shift-TAB key shifts the editor to the previous field.
  587.  
  588.  
  589. Alt-D
  590. -----
  591.  
  592. Loads and displays the default colors of Hexcalibur.
  593.  
  594.  
  595. ENTER
  596. -----
  597.  
  598. Returns to Hexcalibur and saves the colors displayed on the screen to the HC.FIL
  599. file.  These color selections are now permanently saved for all future runs of
  600. Hexcalibur.
  601.  
  602.  
  603. ESC
  604. ---
  605.  
  606. Returns to Hexcalibur without saving the displayed colors. 
  607.  
  608.                                    Tutorial
  609.                                    ======== 
  610.  
  611.  
  612. To begin running Hexcalibur from a DOS prompt, enter the command:
  613.  
  614. hc [filename]
  615.  
  616. where the filename is the name of the file to be edited.  Although the filename
  617. is optional, if it is not provided, Hexcalibur will immediately prompt you for a
  618. file name.
  619.  
  620. Note:  If you have no file to start with, begin editing using the file named
  621. SAMPLE1 supplied on the disk.
  622.  
  623. As you load Hexcalibur, the title screen will first appear on the screen.  As
  624. the program loads the file, a counter at the bottom left hand corner of the
  625. screen displays how many bytes are currently loaded.  As soon as the file is
  626. loaded, press any key to enter the editor.
  627.  
  628. IF THIS IS THE FIRST TIME YOU ARE RUNNING HEXCALIBUR, you may want to change the
  629. screen colors.  To do so, type Alt-C.  You may then change your screen colors as
  630. described on the Color Selection Menu.  (For additional information on color
  631. selection, see the section on "Custom Color Settings".)
  632.  
  633. As the editor comes up, your cursor will be located at the top left hand corner
  634. of the hex window.  To begin, use the arrow keys to move the cursor around the
  635. hex window.  Move to the end of a line and notice that the cursor wraps around
  636. to the next line of the hex window instead of moving over to the text window. 
  637. To change windows use the F2 key.  This will move you to the corresponding
  638. character in the text window.  Now move to the bottom of the screen and you will
  639. see the file scroll up while the cursor holds its position. If you press the
  640. home key, the cursor will move to the beginning of the line of the current
  641. window.  The end key will move the cursor to the end of the line of the current
  642. window.  Try a few page up and page downs.  The entire file will shift a page
  643. (half of a sector) up or down.  For larger jumps through the file you will want
  644. to use the Alt-(0..9) keys.  Try pressing Alt-3.  The cursor will move to a
  645. position 30% of the way through the file.
  646.  
  647.  
  648. Editing in Overtype Mode
  649. ------------------------
  650.  
  651. To start this sample editing session, do the following:
  652.  
  653. 1. Press the insert key to change the program into Overtype mode.
  654. 2. Press function key F2 to switch to the text window.
  655.  
  656. Now begin typing some text characters.  You will notice that the characters you
  657. are typing are overwriting the existing characters.  Also notice that the
  658. corresponding characters in the hex window have changed their values in
  659. accordance with the changes you are making in the text window.
  660.  
  661. Now press function key F2 again, and you will move to the hex window.  While you
  662. are in the hex window, you can only use hexadecimal characters:  0-9 and A-F. 
  663. As you type, you will notice that, as in the text window, the characters you
  664. type will overwrite the character which the cursor sits on.  The corresponding
  665. text characters are updated as well.
  666.  
  667.  
  668. Editing in Insert Mode
  669. ----------------------
  670.  
  671. Now press the insert key and you will notice that, at the upper left hand corner
  672. of the screen, it now says "insert mode" where it used to say "overtype."  Press
  673. the F2 key so that your cursor is in the text window.  Begin typing, and you
  674. will notice that the text from the cursor forward gets shifted forward, and the
  675. typed character is inserted at the cursor.  The cursor is also shifted one space
  676. to the right.  Again, the characters in the hex window are adjusted.
  677.  
  678. Move over to the hex window (by pressing F2) and try typing there.  You will
  679. notice that insert mode in the hex window works a bit differently.  Move the
  680. cursor to the left hex character of a pair.  Type a number and watch all of the
  681. pairs of hex characters shift forward, from the cursor on.  The number pressed
  682. will be inserted into the right hex character and the left hex character will
  683. turn to 0.  The cursor is moved to the right hex character where the typed
  684. number sits.  If you type another number, the right hex character will shift to
  685. become the left hex character, and the character keyed becomes the right hex
  686. character.  The cursor then moves another character to the right.
  687.  
  688.  
  689.  
  690. Working with Blocks
  691. -------------------
  692.  
  693. In order to work with blocks you must always begin by pressing Alt-A (begin
  694. block).  When you do so, you will notice that the mode indicator towards the
  695. upper-left hand corner of the screen is flashing "block mode" and the character
  696. your cursor sits on is now highlighted with a block mode color setting.  You are
  697. now in block mode.  Note: You cannot edit text in block mode, but you can switch
  698. freely between the hex and text window with F2.  Try moving the cursor around
  699. the screen and you will see that the text between the start of the block and the
  700. current position is highlighted.  Now hit F2 to switch to the opposite window
  701. and notice that the block has remained the same.  When you have decided on a
  702. block, look directly above the windows to see the block options:
  703.   Alt-C = copy block   Alt-M = move block   Alt-D = delete block
  704.  
  705. First try a block copy by pressing Alt-C.  The block highlight will disappear,
  706. not the text, and above the windows it will say "Move cursor to destination,
  707. press ENTER." Do as the instructions say and you will see the formerly
  708. highlighted text reappear where the cursor sits.  The cursor will appear at the
  709. end of the copied block.
  710.  
  711. Try the same procedure with move block (Alt-M) this time. You must start a new
  712. block again with Alt-A.  Notice that when you actually press Alt-M, the
  713. highlighted text disappears instead of remaining as with an Alt-C.  Pressing
  714. Enter at the destination will act the same as with an Alt-C.
  715.  
  716. Now try the procedure with delete block (Alt-D) after starting another block
  717. with Alt-A.  When pressing Alt-D, the highlighted block is removed and you are
  718. no longer in block mode.
  719.  
  720. Using Paste Block
  721. -----------------
  722.  
  723. Now imagine that you accidentally deleted the wrong block.  It will be easy to
  724. recover this deleted block with Paste Block (Alt-P).  When pasting a block you
  725. must NOT be in block mode.  The last block used in block mode is automatically
  726. saved in a block buffer and can be retrieved with Alt-P.  Press Alt-P now and
  727. above the windows it will say "Move cursor to destination, press ENTER."  If the
  728. cursor still sits in the same place when the delete was made, you do not need to
  729. move it.  Press Enter and the block will be replaced.  If you wish to do another
  730. Paste block with the same block, you may.  The block remains in the buffer until
  731. it is replaced, when block mode is used. 
  732.  
  733.                             Basic Editing Features
  734.                             ===== ======= ======== 
  735.  
  736. Overtype
  737. --------
  738.  
  739. In overtype mode, anything typed on to the screen will overwrite existing
  740. characters on the screen.  In the hex window, the overwrite will take place over
  741. the character which the cursor is on, as in the text window.  In the hex window,
  742. it edits only the upper or lower eight bits of the corresponding text character
  743. in the text window.  The insert key toggles overtype and insert mode.
  744.  
  745.  
  746. Insert
  747. ------
  748.  
  749. In insert mode, anything typed on to the screen will cause all text, from the
  750. cursor forward, to move up a space, and the typed character to be placed at the
  751. cursor.  When typing in the hex window, the first character typed will be
  752. inserted as the rightmost 4 bits and prefixed by a zero; the second key typed
  753. will cause the first character to be shifted to the left and then the second
  754. character will become the lower 4 bits.  For example, if we have: 
  755.  
  756. 90 91 92 93 94 95 96 97 98 99 9a 9b 9c 9d 9e 9f
  757.  
  758. and we are in insert mode with the cursor over the "9" of "98" and we type a
  759. "6", the display will change to read:
  760.  
  761. 90 91 92 93 94 95 96 97 06 98 99 9a 9b 9c 9d 9e
  762.  
  763. Now the cursor will be over the "6" of the "06" and the characters from "98" up
  764. will have been shifted one full position to the right.  If (note we're still in
  765. insert mode) we now (while over the "6") type "7", the "6" will be moved to the
  766. left and the "7" inserted after it.  The display will then read:
  767.  
  768. 90 91 92 93 94 95 96 97 67 98 99 9a 9b 9c 9d 9e
  769.  
  770. The cursor will be left over the "9" of the "98", which is the next available
  771. position on the screen.
  772.  
  773. The insert key toggles overtype and insert mode.
  774.  
  775.  
  776. Delete
  777. ------
  778.  
  779. When deleting a character, all text beyond that character is shifted back to
  780. fill the void.  In the hex window, both hex characters are deleted with one
  781. keystroke.
  782.  
  783.  
  784. Change Display (Alt-Z)
  785. ----------------------
  786.  
  787. This will change the text window to display either all printable characters or
  788. just ASCII characters.
  789.  
  790.  
  791. Switch Between Hex and Character Edit (F2)
  792. ------------------------------------------
  793.  
  794. This will shift windows to the corresponding character in the other window. 
  795. This allows you to edit using either hex characters or ASCII characters.
  796.  
  797.  
  798. Color Selection (Alt-C)
  799. -----------------------
  800.  
  801. Alt-C will bring up the color selection help screen.  There are six different
  802. color fields to edit: text, background, special characters, help screens, block
  803. characters, and non-printable characters (hex character who have no printable
  804. translation).  The current field being edited is displayed in the top half of
  805. the help screen, and the cursor is located at one of the characters of that
  806. field.  The arrow keys change the color of the current field and the Tab keys
  807. shift fields.  ESC will cancel all color changes and ENTER will save them.
  808.  
  809.  
  810.  
  811.  
  812.                           Moving Around in the File
  813.                           ====== ====== == === ==== 
  814.  
  815. Arrow Keys
  816. ---------- 
  817.  
  818. Using the arrow keys will move the cursor throughout the file.  When reaching
  819. the end of a line or a page, the screen and cursor will automatically wrap. 
  820. Note: The arrow keys will not move the cursor from one window to another.
  821.  
  822.  
  823. Page Up, Page Down
  824. ------------------
  825.  
  826. Paging up and down will shift the file exactly one screen page (256 bytes)
  827. accordingly.
  828.  
  829.  
  830. Home
  831. ---- 
  832.  
  833. Moves the cursor to the beginning of the line of the current window.
  834.  
  835.  
  836. End
  837. --- 
  838.  
  839. Moves the cursor to the end of the line of the current window.
  840.  
  841.  
  842. Beginning of File (Alt-B)
  843. -------------------------
  844.  
  845. Moves the cursor to the beginning of the file.
  846.  
  847.  
  848. End of File (Alt-E)
  849. -------------------
  850.  
  851. Moves the cursor to the end of the file.
  852.  
  853.  
  854. Move to x% of file (Alt-0..9)
  855. -----------------------------
  856.  
  857. Moves to a certain percentage of the file (i.e., Alt-3 moves the cursor to a
  858. position at 30% of the file size).
  859.  
  860.  
  861. Goto (Alt-G)
  862. ------------ 
  863.  
  864. Lets you specify exactly where in the file you want to move to, using sector and
  865. byte values.
  866.  
  867.  
  868. Find (Alt-F)
  869. ------------
  870.  
  871. Searches for a given string in hex or text, depending on the current window, and
  872. then moves the cursor to the position of the string if found.
  873.  
  874.  
  875. Find and Replace (Alt-R)
  876. ------------------------
  877.  
  878. Alt-R prompts for two strings:  a target string and a replacement string.  Each
  879. time the target string is found in the file, you are asked if you want the
  880. replacement to be done.  The possible responses are:
  881.  
  882.   y -- yes:  replace this one occurrence of the target string with the
  883.              replacement string.
  884.   n -- no:   skip this occurrence of the target string but continue searching
  885.              for the next occurrence of the target.
  886.   r -- replace all:  replace all remaining occurrences of the target string
  887.              without prompting again.
  888.  
  889. The ESC key may be used to cancel the Replace operation.
  890.  
  891. Any time while a Find or Replace is in progress, pressing any key on the
  892. keyboard will stop the operation, and the prompt 
  893.  
  894. ENTER = continue / ESC = break
  895.  
  896. will appear.  When this happens, press the ENTER key to continue the operation. 
  897. To abort the operation, press the Escape key.
  898.  
  899.  
  900.                              Block Mode Editing
  901.                              ===== ==== ======= 
  902.  
  903. Block Mode
  904. ----------
  905.  
  906. Block mode is initiated by executing an Alt-A.  In block mode, blocks of text
  907. may be copied, moved, or deleted, regardless of which window you are in.  Both
  908. windows will be updated to the change.  Text cannot be edited in block mode.
  909.  
  910. Begin Block (Alt-A)
  911. -------------------
  912.  
  913. Turns block mode on and places a marker at the current position of the cursor. 
  914. The cursor then should be moved to the position at the end of a desired block
  915. before executing a block action, i.e. copy block.
  916.  
  917. Delete Block (Alt-D)
  918. --------------------
  919.  
  920. To execute a delete block, you must be in block mode.  When the desired block to
  921. remove is highlighted, an Alt-D will delete it.
  922.  
  923. Note:  In case of accidental delete, the block is still available in memory.  It
  924. may be retrieved by typing Alt-P.  After typing Alt-P, move the cursor to the
  925. location where you would like to put the accidentally deleted block, and press
  926. ENTER.  The block will be inserted back into the file.
  927.  
  928. Blocks are only saved to one level deep.  Once a new block has been selected,
  929. the previous block is no longer retrievable.
  930.  
  931. Copy Block (Alt-C)
  932. ------------------
  933.  
  934. To execute a copy block, you must be in block mode.  When the desired block to
  935. copy is highlighted, press Alt-C.  The highlighting of the text will disappear. 
  936. Move the cursor to the desired location where the block is to be copied and
  937. press Enter.
  938.  
  939. Move Block (Alt-M)
  940. ------------------
  941.  
  942. To move a block, you must be in block mode.  When the desired block to move is
  943. highlighted, press Alt-M.  The highlighted text will be removed.  Move the
  944. cursor to the desired destination location and press Enter.
  945.  
  946. Paste Block (Alt-P)
  947. -------------------
  948.  
  949. Alt-P will paste the most recently selected block to any position in the file. 
  950. Alt-P is pressed OUTSIDE of block mode.  It causes the program to retrieve the
  951. most recently selected block and make it available for insertion into the file. 
  952. This may be a block that was previously deleted, moved, or copied.  As with move
  953. block and copy block, after pressing Alt-P, move the cursor to the location in
  954. the file where you desire the block to be inserted, and press ENTER.
  955.  
  956.                                  File Options
  957.                                  ==== ======= 
  958.  
  959. Undo changes (Alt-U)
  960. --------------------
  961.  
  962. Undoes changes in the file since the last save was made. 
  963.  
  964.  
  965. Save File (Alt-S)
  966. -----------------
  967.  
  968. Alt-S causes a small menu to appear in the Hex window.  You are given the option
  969. to rename the file and then save it.  To actually save the file, you must press
  970. the ENTER key in the last box on the menu.  To cancel the save operation, press
  971. the Escape key at any time.
  972.  
  973. If there already exists a file with the name you are attempting to use, you will
  974. be given the option of making a backup file (with the .BAK extension) when the
  975. save takes place.
  976.  
  977. Upon completion of the save, the program returns to normal operation.
  978.  
  979.  
  980. Exit Program (Alt-Q)
  981. --------------------
  982.  
  983. Same as Alt-X.
  984.  
  985.  
  986. Exit Program with Optional Save (Alt-X)
  987. ---------------------------------------
  988.  
  989. Alt-X exits the program and gives an option to save the file.  ESC may used to
  990. escape the exit altogether.
  991.  
  992. Once you have moved to the Save menu via Alt-X, it is impossible to get back to
  993. the program.  Pressing ESC while in the Save menu will exit the program, and the
  994. file will NOT be saved.  (A notice to this effect is posted at the bottom of the
  995. Save menu when Save is entered via Alt-X.)
  996.  
  997.  
  998.  
  999.